                                RemAPollo V1.5

                       Produkt Eccentric Creations (TM)

                 (c) Mikoîaj Caîusiïski 1998-2000. Freeware.

                             Instrukcja obsîugi.

Wstëp
-----

RemAPollo - A1200 040\060 MMU Apollo Turboboard Remapper jest pakietem
freeware (uûywanie go nie wymaga rejestracji ani ûadnych opîat), ale autor
zastrzega sobie wszystkie prawa autorskie. Pakiet zostaî napisany pod wpîywem
mojej rozpaczy, wynikajâcej z braku moûliwoôci podmiany Kickstartu przez
uûytkowników kart Apollo. My, posiadacze tychûe kart byliômy w gorszej
sytuacji, niû wîaôciciele kart typu Blizzard, którzy mogli w dziecinnie prosty
sposób (ustawiajâc jednâ zworkë na karcie) "podmieniê" sobie ROM. My nie
moûemy tego zrobiê - nasze karty nie posiadajâ takich zworek, dodatkowo nie
byîo dotychczas programów umoûliwiajâcych nam takâ operacjë w sposób czysto
programowy. Mam nadziejë, ûe ta nierównoôê zostanie niniejszym wyrównana przez
RemAPollo.

Zwróê uwagë, ûe chociaû RemAPollo nie jest juû w fazie beta testów, to nie
musi to wcale oznaczaê, ûe jest pozbawiony wszelkich bîëdów. Jeûeli wykryjesz
jakiekolwiek nieprawidîowoôci w dziaîaniu programu, skontaktuj sië ze mnâ;
szczegóîowe opisy bîëdów mile widziane. Mój adres znajdziesz w rozdziale
"Autor". Ponadto upewnij sië, ûe uwaûnie przeczytaîeô të instrukcjë!

Rozpowszechnianie
-----------------

Pakiet RemAPollo moûe byê swobodnie rozpowszechniany, przy uwzglëdnieniu
poniûszych kryteriów:

 - Ûaden z plików, wchodzâcych w skîad pakietu nie moûe byê modyfikowany, ani
   pominiëty.

 - Nie moûna pobieraê ûadnych opîat za pakiet, z wyjâtkiem kosztu noônika i
   opîat manipulacyjnych.

 - Pakiet RemAPollo moûe byê doîâczany do zestawów darmowego oprogramowania,
   ale nie moûe byê zamieszczany na komercyjnych pîytach CD-ROM (wîâczajâc w
   to pîyty doîâczane do czasopism tzw. coverdyski). Jeûeli chesz zamieôciê
   ten pakiet na swoim CD-ROMie musisz najpierw zwróciê sië do mnie o
   wyraûenie zgody. Powyûsze nie dotyczy pîyt AminetCD; Administrator Aminetu,
   Urban MÜller, ma mojâ zgodë na umieszczanie pakietu RemAPollo na tychûe
   pîytach.

 - Pakiet RemAPollo nie moûe byê doîâczany do jakiegokolwiek komercyjnego
   produktu, bez mojej pisemnej zgody.

Ostrzeûenie
-----------

UÛYWASZ PLIKÓW, WCHODZÂCYCH W SKÎAD PAKIETU RemAPollo CAÎKOWICIE NA WÎASNE
RYZYKO. NIE PONOSZË ÛADNEJ ODPOWIEDZIALNOÔCI ZA SZKODY SPOWODOWANE
UÛYTKOWANIEM TEGO PAKIETU!

Do czego to wîaôciwie sîuûy?
----------------------------

RemAPollo jest pakietem programów stworzonych dla uûytkowników komputera Amiga
1200, wyposaûonego w kartë turbo Apollo 040/060. W jego skîad wchodzi kilka
plików sîuûâcych do podmieniania Kickstartu - czëôci systemu operacyjnego
Amigi, znajdujâcej sië w ROMie. Moûesz przenieôê Kickstart, który masz
zapisany w ROMie do szybkiej pamiëci, bâdú teû uûyê zupeînie innej wersji
Kickstartu (szczególnie przydatne, gdy jesteô programistâ). Wiëcej szczegóîów
w rozdziale "Korzystanie z pakietu".

Pliki pakietu
-------------

Pakiet RemAPollo skîada sië z nastëpujâcych plików

- 68060.pch - îatka uaktualniajâca bibliotekë 68060 w wersji 60.02 do 60.10

- Converter - komenda umoûliwiajâca konwersjë moduîów BlizKicka (typu
  extresbuf) na format zrozumiaîy dla RemAPollo.

- CopyIDEfixPrefs - programik dla uûytkowników pakietu IDEfix - sîuûy do
  kopiowania preferencji z zewnëtrznego pliku do pliku komendy IDEfix.
  Powinien byê uûyty przez uûytkowników chcâcych zaîadowaê IDEfixa poprzez
  opcjë MODULES mapera

- DRAP - Apollo Remapper Deallocator

- FakeLOCAL - ta komenda ustawia atrybut LOCAL (na Kickstarcie 3.x równieû bit
  KICK) dla pamiëci fast karty Apollo. Dziëki temu wiëkszoôê programów
  rezydentnych zostaje zainstalowana w pamiëci fast zamiast chip. UWAGA!
  Poniewaû ustawienie tych bitów przez uûytkownika jest nielegalne (powinna to
  byê wyîâcznie domena systemu), program ten jest przeznaczony tylko dla
  zaawansowanych uûytkowników! Uûywaj tylko razem z programem RemAPollo i
  tylko jeôli wiesz, co robisz!

- KReader - krótka komenda do zgrywania Kicstartu do pliku ram:Kickstart

- LoadResident - komenda CLI, która sîuûy do odawania/usuwania lub
  wyôwietlania listy moduîów rezydentnych bez koniecznoôci ponownego
  uruchamiania programu RemAPollo.

- Modules/fixramlib - moduî ten poprawia bîâd w ramlibie, uniemoûliwiajâcy
  pracë moduîów AFTERDOS na KS 2.x (np. HappyENV-handler). W przypadku
  Kickstartu 3.x jego uûycie jest zbëdne

- Modules/fixramlib.s - kod úródîowy do tego moduîu

- Modules/HappyConfig - specjalny programik umoûliwiajâcy podanie dodatkowych
  opcji dla moduîu HappyENV-handler przy îadowaniu rezydentnym. Posiada
  nastëpujâce opcje: 'HappyENV-handler,TO,STARTUP/K/F:', gdzie: pierwszy
  argument okreôla ôcieûkë dostëpu do moduîu HappyENV-handler (domyôlnie w
  L:), TO okreôla nazwë zmodyfikowanego handlera, a sîowo kluczowe STARTUP
  sîuûy do podania dodatkowych opcji. Peînâ listë dostëpnych opcji moûesz
  znaleúê w oryginalnej instrukcji do pakietu HappyENV. W celu usuniëcia
  wszystkich opcji uruchom programik bez parametru STARTUP. Przykîady:
  'HappyConfig STARTUP NOREQ' - konfiguruje handler w tryb ignorowania
  nierozpoznanych/nieobsîîugiwanych pakietów
  'HappyConfig' - usuwa wszystkie opcje

- Modules/HappyENV-handler.pch - îatka na ten znany handler, autorstwa Martina
  Giericha, w wersji 1.0, umoûliwiajâca jego rezydentnâ instalacjë i
  poprawiajâca w nim kilka bîedów

- Modules/KingCON-handler.pch - îatka na KingCON-handler 1.3, w wersji 020+,
  umoûliwiajâca jego rezydentne zaîadowanie (dziëki czemu caîkowicie zastëpuje
  on systemowy con-handler)

- Modules/MountENV - poprawiona wersja komendy MountENV

- Modules/noclick - uaktualniona wersja moduîu BlizKicka, który sîuûy do
  wyîâczania "klikania" stacji dysków

- Modules/noclick.s - kod úródîowy do tego moduîu

- MuDRAP - Apollo Remapper Deallocator przeznaczony do uûycia z bibliotekâ
  68040/060 z pakietu mmu.library

- patch - programik do aktualizacji biblioteki 6804(6)0

- RemAPollo - gîówny program remapujâcy

- RemAPollo.doc - angielska wersja dokumentacji

- RemAPollo.doc.info

- RemAPollo.doc.pl - niniejszy tekst

- RemAPollo.doc.pl.info

- RemAPollo.info - fajna ikonka

- RemAPollo.readme - krótki opis dla Aminetu

- Reset - programik resetujâcy

- RUX - OS3.5 ROM Update eXtractor - komenda ulatwiajaca instalacje systemu
  3.5, z zachowaniem jednego resetu na starcie komputera (patrz teû rozdziaî
  "Informacje dodatkowe")

Prawa autorskie
---------------

Amiga, AmigaOS and Kickstart - Copyright © 1985-1999 Amiga International,
Inc.
BlizKick - Copyright © 1996-2000 PitPlane Productions.
Fusion - Copyright ©1997 By Jim Drew & Microcode Solutions
HappyENV-handler - Copyright 1995-1997 Martin Gierich
IDEfix - Copyright 1993 - 1999 Elaborate Bytes, Oliver Kastl.
KingCON-handler - Copyright © 1993,1994 David Larsson
mmu.library project © 1998-2000 the mmu.library development group, THOR
RemAPollo - Copyright © 1998-2000 Mikoîaj Caîusiïski.
ShapeShifter - © Copyright 1993-1999 Christian Bauer.
spatch - Copyright © 1992 SAS Institute, Inc.

Wymagania
---------

Dla poprawnego dziaîania pakietu sâ wymagane: 

- komputer Amiga 1200 lub 4000 (patrz rozdziaî: "Bîëdy")

- przynajmniej wersja 2.0 (V36) systemu operacyjnego (to chyba nie jest
  problem :-)

- karta turbo Apollo 040 lub 060 (procesor musi posiadaê sprawny MMU),
  wyposaûona w przynajmniej 1 MB pamiëci fast

- oryginalna biblioteka 040.library pochodzâca z Commodore w wersjach 37.10
  lub 37.30 (lub 44.2 z OS3.5), jeûeli uûywasz procesora 68040 albo biblioteka
  060.library doîâczana do karty turbo (obecnie program wspóîpracuje tylko z
  wersjâ 60.10), jeûeli uûywasz procesora 68060.


Instalacja
----------

Instalacja, jakkolwiek prosta, skîada sië z kilku czynnoôci, które powinny byê
wykonane starannie i uwaûnie, w przeciwnym razie system prawie na pewno bëdzie
sprawiaî problemy. Poniewaû RemAPollo nie jest przeznaczony dla
niedoôwiadczonych uûytkowników, w pakiecie nie ma skryptu instalacyjnego -
caîâ pracë musisz wykonaê rëcznie.

                                      1.

Najpierw - to bardzo waûne - powinieneô zaktualizowaê plik 040(060).library. W
archiwum z programem znajdziesz specjalny program "patch" do tego celu. Jeûeli
Twoja 040(060).library znajduje sië w katalogu LIBS: i nie zostaîa spakowana,
wystarczy jedynie uruchomiê program "patch" bez ûadnych parametrów. Program
poinformuje Cië o wyniku swojej pracy, niestety tylko po angielsku. UWAGA! W
przypadku procesora 68040 upewnij sië, ûe uûywana przez Ciebie 040.library
pochodzi z Commodore; jeûeli wykorzystujesz bibliotekë pochodzâcâ z innych
úródeî (np. z Phase5) musisz z niej zrezygnowaê. W szczególnoôci remaper nie
bëdzie wspóîpracowaî z bibliotekami Phase5; ich uûywanie nie wpîywa na lepsze
funkcjonowanie kart Apollo.

Jeôli Twoja biblioteka jest spakowana, najpierw rozpakuj jâ, a nastëpnie
wywoîaj program "patch" podajâc ôcieûkë dostëpu do niej. Po skoïczonej
operacji moûesz spakowaê bibliotekë ponownie.

Powyûsza czynnoôê jest ABSOLUTNIE konieczna, dla prawidîowej pracy systemu z
podmienionym Kickstartem. Twoja Amiga moûe dziaîaê poprawnie bez dokonywania
zmian w pliku 040(060).library, ale nie wprowadzajâc ich sam prosisz sië o
kîopoty; za którymô razem system moûe sië "zawiesiê". Jeûeli chcesz dowiedzieê
sië czegoô wiëcej o zmianach wykonywanych przez program "patch" przeczytaj
rozdiaî "Informacje dodatkowe".

Niektóre starsze wersje kart Apollo z procesorem 060, posiadajâ doîâczonâ
bibliotekë 68060 w wersji 60.02, z którâ nie wspóîpracuje programik "patch"
(który wymaga biblioteki w wersji 60.10). Specjalnie dla uûytkowników takich
kart, doîâczyîem specjalnâ îatkë uaktualniajâcâ 68060.library do wersji 60.10.
Aby jâ wykorzystaê, uûyj powszechnie dostëpnego programiku "spatch".

                                      2.

Po zakoïczeniu operacji uaktualniania biblioteki powinieneô skopiowaê program
DRAP (Apollo Remapper Deallocator) do katalogu C:. Do wersji 1.11 wîâcznie,
wywoîanie DRAPa musiaîo nastâpiê po komendzie SetPatch; poczâwszy od wersji
1.12 nie jest to konieczne. Obecnie zaleca sië umieszczenie DRAPa jako
pierwsza komenda w startupie. Odpowiedni fragment Twojego startup-sequence
moûe wyglâdaê tak:

...
DRAP
If WARN
RemAPollo MAC QUIET
EndIf
SetPatch QUIET
...

Stosowanie tego programiku nie jest wymagane dla poprawnego funkcjonowania
relokacji, ale jego uûycie jest ze wszech miar polecane. Jego dziaîanie polega
m.in. na zwolnieniu pamiëci alokowanej przez remaper (dokîadnie 67712
bajtów) i doprowadzeniu systemu do bardziej efektywnego i stabilnego stanu.
Jeûeli zamierzasz korzystaê z funkcji MAC (patrz rozdziaî "Korzystanie z
pakietu") ten program *MUSI* zostaê uruchomiony, w przeciwnym razie emulator
"zawiesi" sië. Uûywanie DRAPa przyspieszy teû nieco pracë systemu, poniewaû
przenosi pierwszâ stronë pamiëci (pierwsze 4kb) z wooolnej pamiëci chip do
pamiëci fast. Wreszcie, zabezpieczy on zmapowany Kickstart przed zapisem.
Moûesz umieôciê DRAPa w startup-sequence na staîe - w przypadku nie wykrycia
relokacji nie robi on nic, z wyjâtkiem ustawienia kodu wyjôciowego (RC) na 5.

Od wersji 1.8 DRAPa istnieje moûliwoôê pewnej jego konfiguracji, jednak
zalecane jest wywoîywanie DRAPa tak, jak dotychczas (bez ûadnych parametrów).
Nowe parametry to: ND (lub NODEALLOC) oraz RH (lub RESTOREHANDLER).

Pierwszy wstrzymuje dealokacje pamiëci (67720 bajtów) uûywanej na tabele MMU.
Tabele te nie sâ potrzebne, jak tylko 68040.library zostanie zainstalowana w
systemie, wiëc w wiëkszoôci przypadków nie powinno sië wywoîywaê tego
przeîâcznika. Jeôli jednak chcesz korzystaê ze statram.device (SDx:) lub masz
problemy ze úle napisanymi programami rezydentnymi (np. SIMBug), powinieneô
wîâczyê NODEALLOC. Bëdziesz miaî mniej pamiëci (67720 bajtów) ale SD0 bëdzie
pracowaê jak powinno.

Drugi parametr (RESTOREHANDLER) wymusza odtworzenie oryginalnej wartoôci
wektora Bus-Error, tak, jak w poprzedniej wersji remapera. Nie jest to
polecane, poniewaû spowoduje zawieszenie sië komputera (o ile nie jest
uruchomiony Enforcer) po zapisie w obszar ROMu.

Od wersji 1.12 zostaîy wprowadzone drobne zmiany w kodzie inicjalizacyjnym
DRAPa, dziëki czemu nie musi on juû byê uruchamiany po komendzie SetPatch -
program teraz sam otwiera 68040\060.library. Wprowadzono teû nowy parametr NR
(NOREMAP), który wyîâcza domyôlne remapowanie tzw. zerowej strony pamiëci z
chipu do fastu. Przy okazji poprawiono teû kompatybilnoôê tej operacji.
Dodatkowe informacje moûesz znaleúê w sekcji Bîëdy. 

                                      3.

Kiedy powyûsze punkty zostanâ zrealizowane moûesz uûyê gîównego programu z
pakietu (patrz rozdziaî "Korzystanie z pakietu").

Relokacja pozostanie aktywna tak dîugo, jak dîugo nie zostanâ naruszone: baza
biblioteki exec ani wektor ColdCapture. Aby pozbyê sië jej z pamiëci uûyj
zaîâczonego w pakiecie programu "Reset" z opcjâ HARD. Program ten wyczyôci
lokacjë 4, usuwajâc z systemu wszelkie rezydenty.

Korzystanie z pakietu
---------------------

Gîówny program pakietu RemAPollo (o tej samej nazwie) moûe byê uruchomiony
zarówno z CLI jak i z Workbencha. Tooltypy sâ praktycznie identyczne z
parametrami CLI, w zwiâzku z czym omówimy tylko te ostatnie.

Standardowa skîadnia (uzyskiwania poprzez wpisanie "?" jako parametru) wyglâda
tak:

KICKFILE,MAC/S,NF=NOPAGEFIX/S,IMJ/S,FORCE/S,QUIET/S,USE=USEKICKPTRS/S,MODULES/
K/F:

Ûaden z parametrów nie jest wymagany. Jeûeli nie podasz wcale argumentów
aktualny ROM zostanie zmapowany, a komputer wykona reset. Amiga zgîosi sië z
tym samym Kickstartem co w ROMie, z jednâ niezwykle uûytecznâ róûnicâ: pamiëê
fast jest przyîâczana w bardzo wczesnej fazie startu systemu (odpada
koniecznoôê uûywania programów typu FastExec). Dziëki temu moûesz takûe
zakîadaê dyski wirtualne RAD w pamiëci fast!

KICKFILE - ten parametr jest uûywany do zlokalizowania pliku z obrazem
Kickstartu, którego chcesz uûywaê. Obsîugiwane sâ tylko Kickstarty 512kB,
zawierajâce nagîówek $1114 lub 256KB z nagîówkiem $1111 i poprawnâ sumë
kontrolnâ. Od wersji 1.4 RemAPollo wspóîpracuje z Kickstartami 1.x (256kB).

Od wersji 0.994 RemAPollo moûe uzywaê spakowanych plików z Kickstartem - w tym
celu musisz zainstalowaê xfdmaster.library.

MAC - uûyj tej opcji, jeûeli korzystasz z programowego emulatora komputerów
Macintosh. Spowoduje ona rezerwacjë pierwszych 16kB pamiëci chip, czego
wymagajâ te programy. Nie musisz juû uûywaê programów typu RsrvCold, RsrvWarm
czy PrepareEmul w swoim startup-sequence. Nie zapomnij wywoîaê programu "DRAP"
zaraz po SetPatchu!

NF lub NOPAGEFIX - ta opcja ma sens tylko przy Kickstarcie 2.x; w wersjach 3.x
jest ignorowana. Jest uûywana do wyîâczenia poprawki w systemie, dotyczâcej
pierwszej strony pamiëci, a dokonywanej automatycznie przez remapera. Na
Kickstartach 2.x pamiëê chip jest przyîâczana do systemu od lokacji $400.
Poniewaû MMU procesorów 040 i 060 moûe pracowaê z najmniejszâ rozdzielczoôciâ
4kB, lepiej jest, aby pamiëê byîa odpowiednio do tego wyrównana (czyli
zaczynaîa sië od adresu $1000). Aby tego dokonaê maper poprawia procedurë
inicjalizacji systemu; poczâwszy od Kickstartu 3.x ta poprawka nie jest juû
potrzebna. Jeôli z jakiegoô powodu nie chcesz zmieniaê oryginalnego zachowania
sië systemu 2.x przy przyîâczaniu pamiëci chip uûyj opcji NOPAGEFIX. Parametr
ten nic nie robi w przypadku uûycia opcji MAC.

FORCE - uûywany jeûeli relokacja jest juû aktywna i chcesz wymusiê ponowne
uûycie mapera. Normalnie remaper nie bëdzie staraî sië dokonaê relokacji,
jeôli stwierdzi takowâ w pamiëci (umoûliwia to stosowanie mapera w
startup-sequence bez ciâgîych resetów komputera).

QUIET - idealna opcja dla chcâcych wykorzystywaê mapera na staîe (w
startupie); powoduje wyîâczenie wypisywania tekstów i skraca oczekiwanie na
reset komputera.

---> Poczâwszy od wersji 1.12, zostaîa dodana nowa opcja: IMJ; jej podanie
spowoduje, ûe maper bëdzie ignorowaî zworkë MEM, która umoûliwia odîâczenie
pamiëci fast umieszczonej na karcie.

O ile nie wybraîeô opcji QUIET, moûesz przerwaê proces mapowania wciskajâc
jednoczeônie klawisze "control" i "c" (CTRL-C).

*****************************************************************************
**** UWAGA! PONIÛSZY AKAPIT JEST PRZEZNACZONY DLA ZAAWANSOWANYCH! UWAGA! ****
*****************************************************************************

---> Poczâwszy od wersji 0.980ß, zostaîa dodana nowa opcja: MODULES

MODULES - ten parametr okreôla lokacjë plików, które majâ byê umieszczone w
pamiëci jako rezydentne razem z mapowanym Kickstartem. Liczba tych plików jest
ograniczona jedynie wielkoôciâ dostëpnej pamiëci (oraz maksymalnâ dîugoôciâ
linii rozkazowej). Moduîem rezydentnym moûe byê kaûdy plik, który posiada
strukturë resident (na przykîad biblioteka czy filesystem). Moûna teû
skorzystaê z tej opcji, aby zaîadowaê IDEFix'a. Uwaga! - opcja ta MUSI byê
podana jako *ostatnia* w linii rozkazowej!

Poczâwszy od wersji 0.996 moûliwe jest wykorzystanie moduîów doîâczanych do
programu BlizKick! Moduîy te wystëpujâ w dwóch postaciach  - jako tzw. îatki
(patch) lub jako rezydenty (extresbuf). Te pierwsze mogâ byê uûywane
bezpoôrednio jak zwykîe moduîy, natomiast pozostaîe naleûy skonwertowaê. W tym
celu uûyj doîâczonego programiku "Converter".

Od wersji 1.2 podawanie za kaûdym razem peînych ôcieûek do moduîów leûâcych w
tym samym katalogu nie jest juû konieczne. Zaîóûmy, ûe chcesz zaîadowaê trzy
moduîy z katalogu DEVS:Mods/. W starszych wersjach, naleûaîoby napisaê tak:

"...MODULES DEVS:Mods/noclick DEVS:Mods/FixMath404 DEVS:Mods/ramlibstack"

Poczâwszy od wersji 1.2 wystarczy podaê ôcieûkë tylko za pierwszym razem:

"RemAPollo MODULES DEVS:Mods/noclick FixMath404 ramlibstack"

---> Poczâwszy od wersji 0.991ß, zostaîa dodana nowa opcja: USEKICKPTRS

USE (lub USEKICKPTRS) - ten parametr zmusza remapera do uûycia bieûâcej listy
rezydentów KickTag i KickMem. Dziëki temu moûliwe jest uûycie innych programów
rezydentnych wymagajâcych resetu, a mimo to nadal mieê tylko jeden reset na
starcie. Aby to osiâgnâê, dodatkowe programy instalujâce sië rezydentnie
powinny byê uruchomione PRZED remaperem i powinny mieê zablokowanâ opcje
wykonania restartu komputera. Np. jeôli uûywasz programu BootControl,
napisanego przez Olivera Kastla i chciaîbyô mieê tylko jeden reset na starcie,
Twój startup powinien wyglâdaê tak:

BootControl INSTALL		;UWAGA: nie uûywaj opcji BOOT!!!
RemAPollo DEVS:Kick3.1 MAC QUIET USE	;dziëki USE maper "widzi" BootControl
SetPatch QUIET
DRAP
...

Zwróê uwagë, ûe wszystkie programiki rezydentne zainstalowane w powyûszy
sposób, zostanâ zaîadowane do pamiëci typu LOCAL, co na wiëkszoôci systemów
oznacza chip. Aby to ominâê, napisaîem programik FakeLOCAL. Powinien on byê
umieszczony jako pierwszy w startup-sequence - powyûszy przykîad bëdzie wiëc
wyglâdaî nastëpujâco:

FakeLOCAL
BootControl INSTALL		;UWAGA: nie uûywaj opcji BOOT!!!
RemAPollo DEVS:Kick3.1 MAC QUIET USE	;dziëki USE maper "widzi" BootControl
SetPatch QUIET
DRAP
...

Teraz BootControl zostanie zaîadowany do pamiëci fast karty.

UWAGA: programik FakeLOCAL jest napisany niezgodnie z systemem (stanowi tzw.
hack) i powinien byê wywoîywany tylko, jeôli przed resetem zostanie uûyty
takûe RemAPollo! Jeôli nie rozumiesz znaczenia bitów LOCAL i KICK - lepiej nie
uûywaj tego programiku!!!

*****************************************************************************
*****************************************************************************
*****************************************************************************


Jeûeli potrzebny Ci przykîad, oto jak wyglâdajâ pierwsze linijki mojego
startupu:

DRAP
If WARN
FakeLOCAL	;uûywam tego TYLKO ze wzgîëdu na MountCD îadowany niûej!
MountCD CD0 QUIET
RemAPollo MAC QUIET USE MODULES C:IDEfix L:KingCON-handler FastFileSystem
EndIf
SetPatch QUIET

Mam Kickstart 3.1 w ROMie, wiëc nie muszë podawaê nazwy pliku. Jeôli uûywasz
Kickstartu 3.0, powinieneô wpisaê coô w tym stylu:

RemAPollo DEVS:Kickstart3.1 MAC QUIET c:IDEFix l:FastFileSystem

Oczywiôcie, zakîadam ûe posiadasz odpowiedni plik w DEVS:.

Informacje dodatkowe
--------------------

Rezydentny kod remapera jest zabezpieczony sumâ kontrolnâ aby zapewniê
wîaôciwy start komputera - jeôli zostanie wykryta jakakolwiek zmiana w tym
kodzie, program ustawi ekran na czerwono i zresetuje Amigë.

Maper korzysta z wektora ColdCapture, aby przetrwaê pomiëdzy resetami, wiëc
nie powinieneô uûywaê ûadnych programów posîugujâcych sië nim. Dodatkowo jest
równieû podmieniany wektor bus error procesora ($00000008) i powinien pozostaê
niezmieniony, dopóki nie zostanie zainicjalizowana 040(060).library, co
normalnie wykonuje SetPatch. Dopiero po tym powinieneô uruchomiê program DRAP,
aby przywróciê oryginalnâ postaê tego wektora. Weú powyûsze pod uwagë podczas
sprawdzania systemu programem antywirusowym.

Aby zmapowaê Kickstart, RemAPollo musi zbudowaê tabele MMU, co zajmuje pamiëê.
Staraîem sië ograniczyê jej wielkoôê do niezbëdnego minimum, w zwiâzku z czym
maper uûywa 8 kB tablic MMU. Niestety takie rozwiâzanie powoduje konflikt ze
sposobem, w jaki biblioteki 040.library i 060.library instalujâ swoje 4 kB
tablice. Nie wyîâczajâ one MMU przed zaîadowaniem tzw. root pointerów co
prowadzi do nieprzewidywalnych reakcji systemu. Spójrz na odnoôny fragment
kodu 040.library w wersji 37.30:

(wejôcie w të procedurë nastëpuje z wîâczonym MMU, ustawionym na tryb 8k)

	ori.w	#$700,SR
	pflusha
	move.l	(A0)+,D0
	movec	D0,URP		;!!! URP wskazuje na 4k tablice!!!
	move.l	(A0)+,D0
	movec	D0,SRP		;!!! SRP wskazuje na 4k tablice!!! - BUUUM!
	move.l	(A0)+,D0
	movec	D0,TC		;MMU zostaje przeîâczony na tryb 4k, trochë póúno...
	pflusha
	moveq	#0,D0
	movec	D0,ITT0
	movec	D0,ITT1
	movec	D0,DTT0
	movec	D0,DTT1
	rte

Aby ta procedura dziaîaîa naleûy dodaê nastëpujâcy kod:

	ori.w	#$700,SR
	moveq	#0,d0
	movec	d0,TC		;wyîâcz MMU
	pflusha

... i to wîaônie robi program "patch".

UWAGA: Jeûeli chcesz uûywaê Kickstartu z pliku, upewnij sië, ûe posiadasz
wîaôciwâ jego wersjë, przystosowanâ do pracy z Twoim komputerem. Np. pliki
Kickstartów, pochodzâce z A4000 (o wersjach 40.7x) nie bëdâ dziaîaîy poprawnie
na A1200!

                                     ***

Uûytkownicy OS3.5, czytajcie:

Wielu z Was zapewne zastanawiaîo sië czy RemAPollo bëdzie wspóîpracowaî z
systemem 3.5. Bez obaw: nie ma problemów. Wszystkie wersje pakietu sâ zgodne z
najnowszâ aktualizacjâ AmigaOS; nie powinno byê równieû problemów z
ewentualnymi przyszîymi poprawkami systemu operacyjnego. Jednakûe bieûâca
wersja 1.3 pakietu remapera idzie nieco dalej w uîatwieniach przy instalacji
systemu 3.5. W tym celu zostaî doîâczony specjalny programik "RUX", który
sîuûy do "wyciâgniëcia" rezydentnych modulow z pliku 'AmigaOS ROM Update'
(znajdujâcego sië zwykle w DEVS:). Dziëki temu powodujâca drugi reset
instalacja tych moduîów przez SetPatch, staje sië zbëdna. RUX reaguje na
nastëpujâce parametry:

FILE,A600/S,A1200/S,A3000/S,A4000I/S,A4000S/S

FILE - wskazuje na plik 'AmigaOS ROM Update' (domyôlnie szukany w DEVS:)

Pozostaîe opcje okreôlajâ typ komputera, dla którego majâ byê przeznaczone
"wyciâgane" moduîy:

A600 - raczej nie bëdziesz uûywaê tego przeîâcznika, gdyû "produkuje" on
       moduîy przeznaczone dla procesora 68000
A1200 - przewaûnie bëdziesz uûywaê tego
A3000 - dla Amigi 3000
A4000I - dla Amigi 4000 jeôli uûywasz tylko wbudowanego interfejsu IDE
A4000S - dla Amigi 4000T z kontrolerem SCSI

Zatem po dokonanej instalacji przy uûyciu instalera z pîyty, moûesz dokonaê
nastëpujâcych korekt:

1. w katalogu LIBS: utwórz jakiô katalog (np. OS3.5)
2. przenieô z LIBS: do tego katalogu biblioteki workbench i icon
3. pamiëtaj aby usunâc te biblioteki z LIBS: (to waûne!)
4. zakîadajâc, ûe jesteô posiadaczem A1200, a plik "AmigaOS ROM Update"
znajduje sië w DEVS:, otwórz okienko shella, zmieï katalog bieûâcy na
LIBS:OS3.5/ i wpisz "RUX A1200"
5. stworzone zostanâ 3 pliki o nazwach: OS_Module1 OS_Module2 i OS_Module3 -
sâ to rezydentne moduîy, które naleûy podaê przy opcji MODULES mapera
6. usuï plik "AmigaOS ROM Update" z DEVS: (zalecane) lub uûyj opcji
NOROMUPDATE SetPatcha

Poczâtek Twojego startup-sequence powinien przypominaê coô takiego (oczywiôcie
dostosuj to do swojej konfiguracji i upodobaï):

DRAP
If WARN
;--------- to poniûej oczywiôcie w jednej linii
RemAPollo DEVS:Kick3.1 MAC QUIET MODULES LIBS:OS3.5/OS_Module1 OS_Module2
OS_Module3 workbench.library icon.library
;---------
EndIf
SetPatch QUIET NOROMUPDATE
...

Zazwyczaj moûesz opuôciê pierwszy moduî (OS_Module1), a w przypadku, gdy
uûywasz teû IDEfixa lub FastATA, rownieû opuôê scsi.device. Prawdziwâ nazwë i
funkcjë danego moduîu moûesz odczytaê z jego komentarza.

Dziëki takiej instalacji, unikniesz dwukrotnego resetu przy "zimnym" starcie
komputera.

                                     ***

Uûytkownicy mmu.library majâ teraz moûliwoôê peînego skorzystania z pakietu;
w tym celu zostaîa zamieszczona komenda MuDRAP (bëdâca w fazie
eksperymentalnej). Jeôli ktoô chce uûywaê biblioteki 68040/060 doîâczonej do
pakietu mmu.library musi zastâpiê zwykîâ komendë DRAP jej odpowiednikiem,
czyli MuDRAP. Ze wzglëdu na sposób pracy mmu.library, instalacja RemAPollo
jest nieco inna, niû opisana wyûej. RemAPollo powinien byê umieszczony PRZED
komendami SetPatch i MuDRAP, a MuDRAP musi byê uruchomiony zaraz PO SetPatchu:

... RemAPollo <opcje>
SetPatch
MuDRAP <opcje>
 ...

Nie naleûy uûywaê programiku 'patch' na bibliotece 68040/060 z pakietu
mmu.library!

UWAGA!: Doîâczona komenda MuDRAP ma charakter wysoce eksperymentalny i powinna
byê uûyta TYLKO z bibliotekâ 68040/060 z pakietu mmu.library!!! Efekty uûycia
komendy MuDRAP z innymi wersjami biblioteki 68040/060 nie sâ do koïca
zdefiniowane!!!

                                     ***

Bîëdy
-----

Ramdysk sterowany przez statram.device (SDx:) nie bëdzie pracowaî poprawnie na
domyôlnej konfiguracji pakietu RemAPollo. Aby to zmieniê, wywoîaj DRAPa z
opcjâ "ND".

OXYPatcher nie instaluje poprawnie swojego portu na wiëkszoôci systemów. Nie
jest to moja wina - OXYPatcher jest úle napisany.

Poczâwszy od wersji 119.11 (3.1) programu IDEfix, autor zmieniî koncepjë
zapisu preferencji. Sâ one teraz zapisywane do osobnego pliku, co sprawia, ûe
îadujâc IDEfixa opcjâ MODULES, przestaje on widzieê swoje preferencje. Uûyj
programiku CopyIDEfixPrefs, aby zapisaê preferencje wewnâtrz IDEfixa.

Jeôli jesteô posiadaczem Amigi 4000 musisz zostawiê puste pierwsze gniazdo
pamiëci na karcie; w przeciwnym wypadku maper nie bëdzie dziaîaê!

Otrzymaîem kilka raportów wskazujâcych na problemy z pewnymi starszymi grami
na systemie z aktywnym RemAPollo. Dotyczyîo to gîównie tzw. gier NDOS, które
sâ obecnie licznie "fixowane" do pracy z lepszymi procesorami i wyposaûane w
loadery z twardego dysku. Próba uruchomienia niektórych gier tego typu
owocowaîa problemami z grafikâ lub wrëcz powodowaîa zawieszenie sië komputera.
Powyûsza sytuacja byîa spowodowana przez programik DRAP, który domyôlnie
przenosiî tzw. stronë zerowâ pamiëci chip (pierwsze 4 lub 16kb w przypadku
uûycia opcji MAC) do szybkiej pamiëci karty. Mówiâc szczerze, nie powinno to
powodowaê ûadnych problemów, poniewaû kaûdy program napisany zgodnie z
wytycznymi byîego Commodore, nie powinien uûywaê niezaalokowanej pamiëci.
Niestety, w praktyce róûnie to bywa - dlatego postanowiîem zmieniê nieco
sposób przeprowadzenia tego mapowania. Najpierw spróbuj pracy z nowym DRAPem,
a jeôli to nie pomoûe, uûyj jego nowej opcji NR (NOREMAP), która spowoduje
caîkowite wyîaczenie przenoszenia pierwszej strony chipu do fastu. Zwróê
jednak uwagë, ûe po uûyciu Fusiona (emulatora Macintosha na Amigë) znów
bëdziesz miaî te same problemy z uruchomieniem tych starych gier, poniewaû
Fusion wykonuje to mapowanie we wîasnym zakresie. Dotyczy to tak pracy z
RemAPollo jak i bez niego.


Historia
--------

V0.1ALFA - (??.9.98) - wersje wewnëtrzne tylko do wîasnego uûytku

V0.96ß - (23.12.98) - pierwsza wersja semi-publiczna (dla wybranych testerów)

V0.97ß - (1.1.99) zmiany:
 - cache procesora sâ inwalidowane przed wîâczeniem
 - wîâczany jest tylko cache dla instrukcji
 - kod rezydentny sprawdza teraz sumë kontrolnâ Kickstartu (jeôli
   nieprawidîowa, komputer jest resetowany z usuniëciem mapera z pamiëci)

V0.973ß - (8.1.99)
 - poprawione rozpoznawanie przez Kickstart pamiëci tzw. slow ($c00000); to
   powino wyeliminowaê zawieszanie sië mapera na niektórych systemach. Dziëki
   dla Arkadiusza Winiarka i Marcina Ostrowskiego za zwrócenie uwagi na ten
   problem.

V0.974ß - (12.1.99)
 - po wykryciu procesora 68060, maper ustawia odpowiedniâ flage w strukturze
   biblioteki exec.

V0.975ß - (13.1.99)
 - inteligentniejsze rozpoznawanie relokacji przez maper, dziëki czemu moûna
   uûywaê niektórych (dobrze napisanych) programów, które wykorzystujâ wektor
   coldcapture. Pierwsza wersja publiczna.

V0.976ß - (26.1.99)
 - zmiana nagîówka mapowanego Kickstartu na 'MM', w celu unikniëcia problemów
   przy próbie ponownego jego zmapowania (RemAPollo dokonuje pewnych zmian w
   obrazie Kickstartu).

V0.977ß - (28.1.99)
 - poprawiony bîâd w procedurze resetujâcej.

V0.980ß - (1.2.99)
 - dodana moûliwoôê îadowania rezydentnych moduîów (IDEFix, pliki beta od
   Amigi International) razem z Kickstartem.

V0.981ß - (4.2.99)
 - usuniëte bîëdy w procedurze alokacji przy opcji MODULES
 
V0.982ß - (5.2.99)
 - maper sprawdza teraz czy nie sa podane te same moduly kilkakrotnie
 - kilka zmian wewnëtrznych
 - dodano nowe pliki do pakietu: LoadResident i KReader

Pozostaîa czëôê loga w wersji angielskiej instrukcji.

Podziëkowania
-------------

Wielkie dziëki Harremu Sintonenowi, który przesîaî mi kilka wstëpnych
informacji dotyczâcych MMU procesora 040. Byîo to dawno temu, ale pomogîy mi
one rozpoznaê problem, z którym zamierzaîem sië zmierzyê.

Ciepîe buziaczki dla firmy Motorola ;-) za znakomity dziaî dystrybucji
literatury, który zapewnia wszystkim chëtnym dostëp do szerokiego wyboru
drukowanych materiaîów; a wszystko to caîkowicie za darmo!

Wreszcie dziëki wszystkim alfatesterom, którzy zgodzili sië ryzykowaê
stabilnoôê swych systemów, zmagajâc sië z licznymi wresjami pakietu RemAPollo
(szczególnie dziëkujë Marcinowi Ostrowskiemu, który pomógî mi namierzyê bardzo
powaûny bîâd; mam nadziejë, ûe uda Ci sië w koïcu opanowaê system... ;)

Specjalne podziëkowania dla Oliviera Fabre za bugreporty i wytrwaîoôê w
testowaniu programu na 68060.

Mojemu bratu Jackowi za niniejsze tîumaczenie.

Ten program dedykujë Ministry - zespoîowi tworzâcemu muzykë, nie wszechobecne
g...no, jakim jest rap.

Autor
-----
Mój adres e-mail (preferowana forma kontaktu): bloelle@priv.gold.pl lub
bloelle@polbox.com


oraz adres dla zwykîej poczty:

                              Mikoîaj Caîusiïski
                            ul. Olsztyïska 113/117
                              42-200 Czëstochowa

Mam nadziejë, ûe ten program przyda Ci sië. Baw sië dobrze!
                                                            Mikoîaj.

      ------------> AMIGA - NAJLEPSZY KOMPUTER POD SÎOÏCEM <------------
